home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / os2 / cpumon.zip / MONITOR.HLP (.txt) < prev    next >
OS/2 Help File  |  1992-09-20  |  30KB  |  1,033 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Copyright Information ΓòÉΓòÉΓòÉ
  3.  
  4. Copyright (c) BonAmi Software Corporation, 1991, 1992.  All rights reserved. 
  5.  
  6. For all product information, please contact: 
  7.  
  8. BonAmi Software Corporation
  9. 60 Thoreau Street, Suite 219
  10. Concord, Massachusetts 01742
  11. U.S.A.
  12.  
  13. Telephone: (508) 371-1997
  14.  
  15.  
  16. ΓòÉΓòÉΓòÉ 2. Contacting BonAmi ΓòÉΓòÉΓòÉ
  17.  
  18. For all product information, please contact: 
  19.  
  20. BonAmi Software Corporation
  21. 60 Thoreau Street, Suite 219
  22. Concord, Massachusetts 01742
  23. U.S.A.
  24.  
  25. Telephone: (508) 371-1997
  26.  
  27.  
  28. ΓòÉΓòÉΓòÉ 3. Help for Help ΓòÉΓòÉΓòÉ
  29.  
  30. Most of the menu items have help available.  Select Extended Help for an 
  31. overview of CPU Monitor. Select Keys Help for a description of the special key 
  32. assignments and combinations used by CPU Monitor. 
  33.  
  34.  
  35. ΓòÉΓòÉΓòÉ 4. Keys Help ΓòÉΓòÉΓòÉ
  36.  
  37. The special keys and key-combinations usable in CPU Monitor are: 
  38.  
  39.  F1        Display context sensitive help; 
  40.  Shift-F3  Save current selections and preferences; 
  41.  Ctrl-0    Display the percent CPU time used by each process; 
  42.  Ctrl-1    Display all processes; 
  43.  Ctrl-2    Display the percent CPU idle time; 
  44.  Ctrl-3    Display all process threads; 
  45.  Ctrl-C    Modify system defaults and configuration; 
  46.  Ctrl-D    Disable the timed display; 
  47.  Ctrl-E    Enable the timed display; 
  48.  Ctrl-F    Display specific data fields; 
  49.  Ctrl-K    Kill a specified process; 
  50.  Ctrl-L    Log output to a file; 
  51.  Ctrl-N    Update the display now! 
  52.  Ctrl-O    Modify how the display is ordered; 
  53.  Ctrl-P    Change a thread's priority; 
  54.  Ctrl-R    Recalibrate CPU timing used by CPU Monitor; 
  55.  Ctrl-S    Select specific processes and threads to display; 
  56.  Ctrl-T    Start a specified program; 
  57.  Ctrl-U    Suspend a specified thread; 
  58.  Ctrl-V    Select the customized display. 
  59.  Alt-B     Copy current screen to the clipboard as a bitmap. 
  60.  Alt-T     Copy the complete current display to the clipboard as text. 
  61.  
  62.  
  63. ΓòÉΓòÉΓòÉ 5. About CPU Monitor ΓòÉΓòÉΓòÉ
  64.  
  65. Use CPU Monitor to monitor and control the programs executing on your computer. 
  66. CPU Monitor provides you with facilities to: 
  67.  
  68.  o Start and stop programs under your control; 
  69.  o Change the execution priority and state for a process or its threads; 
  70.  o Continuously monitor the CPU usage for processes and threads. 
  71.  
  72.  Under OS/2, a program, its data, and its threads of execution are collectively 
  73.  called a process.  A process is created when a program is loaded into memory 
  74.  by the OS/2 system loader (part of the OS/2 kernel). 
  75.  
  76.  Threads in a process run independently, each with their own stack and 
  77.  execution privileges.  OS/2 is multitasking in that threads from multiple 
  78.  processes all compete for and share the computer's CPU, memory, and device 
  79.  resources. 
  80.  
  81.  CPU Monitor allows you to closely examine and control the operation of OS/2. 
  82.  You select the data that you want to monitor and how you want that data 
  83.  displayed. 
  84.  
  85.  The Commands pull-down menu allows you to: 
  86.  
  87.  o Start a new process from CPU Monitor; 
  88.  o Stop a currently executing process; 
  89.  o Change the execution priority of individual threads within a process; 
  90.  o Suspend a currently executing thread; 
  91.  o Instantaneously examine the current CPU Utilization data. 
  92.  
  93.  Use the View pull-down menu to: 
  94.  
  95.  o Select specific processes and threads to display; 
  96.  o Fully customize the CPU Monitor display; 
  97.  o Choose from several useful predefined displays. 
  98.  
  99.  Use the Options menu to customize, enable, and disable the display.  Also use 
  100.  this to set the statistics gathering parameters. 
  101.  
  102.  Use the File pull-down menu to: 
  103.  
  104.  o Log CPU Monitor output to a file; 
  105.  o Recalibrate the CPU timing used by CPU Monitor; 
  106.  o Save or reset current display selections and preferences; 
  107.  o UnInstall CPU Monitor; 
  108.  o Copy the CPU Monitor display to the clipboard in different formats. 
  109.  
  110.  Additional help is available for all menu choices. 
  111.  
  112.  To quit CPU Monitor, select Close from the System Menu or the Window/Task 
  113.  list. 
  114.  
  115.  
  116. ΓòÉΓòÉΓòÉ 6. File Menu Help ΓòÉΓòÉΓòÉ
  117.  
  118. Commands available from the File menu are: 
  119.  
  120.  o Log output to a file; 
  121.  o Recalibrate CPU Monitor for your computer; 
  122.  o Save current display options; 
  123.  o Reset selectable display options; 
  124.  o UnInstall CPU Monitor from OS/2; 
  125.  o Copy CPU Monitor display to the clipboard. 
  126.  
  127.  
  128. ΓòÉΓòÉΓòÉ 6.1. Log Menu Item ΓòÉΓòÉΓòÉ
  129.  
  130. Use this to change the file logging status.  Select a file for file logging, or 
  131. disable file logging.  When logging is enabled and a log file has been 
  132. selected, CPU Monitor copies the displayed system data to the log file. 
  133.  
  134. The rate at which new data is appended to the log file is determined by the 
  135. display frequency setting.  New data is appended each time the screen is 
  136. updated.  The display frequency rate  may be modified via the Configure menu 
  137. item. 
  138.  
  139. Note:  Data may be logged to at most one file at a time. 
  140.  
  141. File logging can also be automatically enabled when CPU Monitor starts via a 
  142. Command Line switch.  See the User's Guide for details on using the command 
  143. line switches. 
  144.  
  145. The log dialog is selected from the File Menu or with the Ctrl-L hot key. 
  146.  
  147.  
  148. ΓòÉΓòÉΓòÉ 6.2. Recalibrate Menu Item ΓòÉΓòÉΓòÉ
  149.  
  150. Use this to recalibrate the CPU timing for your computer.  Calibration refers 
  151. to the CPU Utilization estimates that CPU Monitor provides for its own threads. 
  152.  
  153. Note:  Recalibration is only relevant if the statistics are currently gathered 
  154. using the Alternate frequency selection.  In this case, and under heavy system 
  155. loads, CPU Monitor's internal processing and timing loops may take longer to 
  156. execute than the original calibration estimated.  Recalibrating under these 
  157. circumstances may improve the CPU Utilization accuracy to some degree. 
  158.  
  159. CPU Monitor performs an initial calibration for your computer each time you 
  160. restart OS/2.  This setting will perform well for all applications and 
  161. development activities.  Recalibrating is only provided for consistency with 
  162. previous CPU Monitor versions and as explained above.  For all other cases, 
  163. recalibration is no longer necessary. 
  164.  
  165. Recalibration is selected from the File Menu or with the Ctrl-R hot key. 
  166.  
  167.  
  168. ΓòÉΓòÉΓòÉ 6.3. Save Menu Item ΓòÉΓòÉΓòÉ
  169.  
  170. Use this to save the current program options and settings.  When CPU Monitor is 
  171. next started, the saved options will automatically be restored. The options 
  172. saved are the current values for: 
  173.  
  174.  o Screen colors; 
  175.  o Display window dimensions; 
  176.  o Display number base; 
  177.  o Display font; 
  178.  o Custom display fields and ordering; 
  179.  o Display frequency rate; 
  180.  o Statistics gathering frequency; 
  181.  o Currently selected display. 
  182.  
  183.  Save is selected from the File Menu or with the Shift-F3 hot key. 
  184.  
  185.  
  186. ΓòÉΓòÉΓòÉ 6.4. Reset Menu Item ΓòÉΓòÉΓòÉ
  187.  
  188. Use this to reset all user selectable settings to their factory defaults. The 
  189. following settings are reset: 
  190.  
  191.  o Screen colors; 
  192.  o Display font; 
  193.  o Custom display fields and ordering; 
  194.  o Display frequency rate; 
  195.  o Statistics gathering frequency; 
  196.  o Default display; 
  197.  o Log file and logging status; 
  198.  o Display Enabled; 
  199.  o Selected processes in customized display. 
  200.  o Display number base; 
  201.  
  202.  Note:  Reset does not cause any of the reset settings to be saved.  The Save 
  203.  menu option is required to save these values. 
  204.  
  205.  Reset is selected from the File Menu. 
  206.  
  207.  
  208. ΓòÉΓòÉΓòÉ 6.5. UnInstall Menu Item ΓòÉΓòÉΓòÉ
  209.  
  210. To permanently unload CPU Monitor from your system, select UnInstall. 
  211. References to the CPU Monitor device driver in the CONFIG.SYS file must be 
  212. removed manually.  The Un-Installation process will be complete only after the 
  213. computer has been restarted.  Of course, CPU Monitor may be reinstalled later 
  214. at your convenience. 
  215.  
  216. For more details on the Installation and Un-Installation process, refer to the 
  217. CPU Monitor User's Guide. 
  218.  
  219. UnInstall is selected from the File Menu. 
  220.  
  221.  
  222. ΓòÉΓòÉΓòÉ 6.6. Clipboard Menu Items ΓòÉΓòÉΓòÉ
  223.  
  224. There are two clipboard options available.  Copy Bitmap copies a bitmap 
  225. graphics image of the current CPU Monitor display to the clipboard.  Copy Text 
  226. copies the complete CPU Monitor display, including areas beyond the scroll 
  227. regions, as text lines to the clipboard. 
  228.  
  229. Choose the clipboard copy option that is most convenient for your application. 
  230.  
  231. The clipboard commands are selected from the File Menu or with the Alt-B and 
  232. Alt-T hot keys. 
  233.  
  234.  
  235. ΓòÉΓòÉΓòÉ 6.6.1. Copy Text to Clipboard Menu Item ΓòÉΓòÉΓòÉ
  236.  
  237. Use this to copy the current CPU Monitor display, including areas beyond any 
  238. scroll regions, to the clipboard.  Each line of the display is copied as 
  239. unformatted text.  No graphics are included. 
  240.  
  241. Choose Copy Bitmap to copy the current CPU Monitor display window as a 
  242. graphical bitmap image to the clipboard. 
  243.  
  244. The Copy Text clipboard command is selected from the File Menu or with the 
  245. Alt-T hot key. 
  246.  
  247.  
  248. ΓòÉΓòÉΓòÉ 6.6.2. Copy Bitmap to Clipboard Menu Item ΓòÉΓòÉΓòÉ
  249.  
  250. Use this to copy the CPU Monitor display as a graphical bitmap image to the 
  251. clipboard.  Only that portion of the display currently visible is included. 
  252.  
  253. Choose Copy Text to copy the full CPU Monitor display to the clipboard as 
  254. individual lines of text. 
  255.  
  256. The Copy Bitmap clipboard command is selected from the File Menu or with the 
  257. Alt-B hot key. 
  258.  
  259.  
  260. ΓòÉΓòÉΓòÉ 7. View Menu Help ΓòÉΓòÉΓòÉ
  261.  
  262. Commands available from the View menu are: 
  263.  
  264.  o Select processes to monitor; 
  265.  o Set the display order criteria; 
  266.  o Choose the fields to include in the display. 
  267.  
  268.  In addition, there are four pre-defined and one custom display  options.  They 
  269.  are: 
  270.  
  271.  o Display the percent CPU time used by each process; 
  272.  o Display all processes; 
  273.  o Display the percent CPU Idle time; 
  274.  o Display all threads; 
  275.  o Display using the currently configured custom settings. 
  276.  
  277.  
  278. ΓòÉΓòÉΓòÉ 7.1. Select Menu Item ΓòÉΓòÉΓòÉ
  279.  
  280. Use this to select the specific processes and threads to be displayed.  Only 
  281. those processes chosen will be included in the display.  This option is useful 
  282. to focus on certain key processes. 
  283.  
  284. Select is selected from the View Menu or with the Ctrl-S hot key. 
  285.  
  286.  
  287. ΓòÉΓòÉΓòÉ 7.2. Ordering Menu Item ΓòÉΓòÉΓòÉ
  288.  
  289. Use this to choose how the individual items in the display are ordered. Choose 
  290. ascending or descending ordering based upon: 
  291.  
  292.  o Percent CPU Utilization; 
  293.  o Process ID; 
  294.  o Process Name; 
  295.  o Process Priority; 
  296.  o Session ID; 
  297.  o Parent's Process ID. 
  298.  
  299.  Ordering is selected from the View Menu or with the Ctrl-O hot key. 
  300.  
  301.  
  302. ΓòÉΓòÉΓòÉ 7.3. Fields Menu Item ΓòÉΓòÉΓòÉ
  303.  
  304. Use this to select the specific data fields to include in the display.  The 
  305. following information can be included: 
  306.  
  307.  o Process ID; 
  308.  o Process Name; 
  309.  o Process Priority; 
  310.  o Thread ID for each thread in the process; 
  311.  o Percent CPU time idle; 
  312.  o Process Execution State; 
  313.  o Session ID; 
  314.  o Percent CPU time used by process or thread; 
  315.  o Parent's Process ID; 
  316.  
  317.  The field choices are preserved even if a pre-defined display mode is chosen. 
  318.  To return to the selected field choices, invoke the Customize view menu item. 
  319.  
  320.  The field choices are not automatically preserved when CPU Monitor is 
  321.  terminated.  To save these choices, select the Save menu item from the File 
  322.  menu. 
  323.  
  324.  Fields is selected from the View Menu or with the Ctrl-F hot key. 
  325.  
  326.  
  327. ΓòÉΓòÉΓòÉ 7.4. CPU Time Menu Item ΓòÉΓòÉΓòÉ
  328.  
  329. Use this predefined display to view the Percent CPU time used by each process 
  330. in decreasing order. 
  331.  
  332. View CPU Time is selected from the View Menu or with the Ctrl-0 hot key. 
  333.  
  334.  
  335. ΓòÉΓòÉΓòÉ 7.5. Process ID's Menu Item ΓòÉΓòÉΓòÉ
  336.  
  337. Use this predefined display to view information for all processes in Process ID 
  338. order. 
  339.  
  340. View Process ID's is selected from the View Menu or with the Ctrl-1 hot key. 
  341.  
  342.  
  343. ΓòÉΓòÉΓòÉ 7.6. Idle Menu Item ΓòÉΓòÉΓòÉ
  344.  
  345. Use this predefined display to view the Percent CPU time idle. 
  346.  
  347. View Idle is selected from the View Menu or with the Ctrl-2 hot key. 
  348.  
  349.  
  350. ΓòÉΓòÉΓòÉ 7.7. Threads Menu Item ΓòÉΓòÉΓòÉ
  351.  
  352. Use this predefined display to view information for all threads in Process and 
  353. Thread ID order. 
  354.  
  355. View Threads is selected from the View Menu or with the Ctrl-3 hot key. 
  356.  
  357.  
  358. ΓòÉΓòÉΓòÉ 7.8. Customize Menu Item ΓòÉΓòÉΓòÉ
  359.  
  360. Use this to select a customized display as specified by the Select, Fields, and 
  361. Order menu items. 
  362.  
  363. View Custom is selected from the View Menu or with the Ctrl-V hot key. 
  364.  
  365.  
  366. ΓòÉΓòÉΓòÉ 8. Commands Menu Help ΓòÉΓòÉΓòÉ
  367.  
  368. Commands available from the Commands menu are: 
  369.  
  370.  o Update the display now! 
  371.  o Kill a specified process; 
  372.  o Change a thread's priority; 
  373.  o Suspend a currently executing thread; 
  374.  o Start a specified program. 
  375.  
  376.  
  377. ΓòÉΓòÉΓòÉ 8.1. Update Now Item ΓòÉΓòÉΓòÉ
  378.  
  379. Use this to force an update of the latest statistics data.  This will also 
  380. update the log file if File Logging is enabled. 
  381.  
  382. Update Now! is selected from the Commands Menu or with the Ctrl-N hot key. 
  383.  
  384.  
  385. ΓòÉΓòÉΓòÉ 8.2. Kill Menu Item ΓòÉΓòÉΓòÉ
  386.  
  387. Use this to terminate a selected process.  Note that programs may take 
  388. preventive action to prevent being terminated.  Also, in some cases a selected 
  389. process cannot be terminated.  When this occurs, a warning message will be 
  390. displayed. 
  391.  
  392. Kill is selected from the Commands Menu or with the Ctrl-K hot key. 
  393.  
  394.  
  395. ΓòÉΓòÉΓòÉ 8.3. Priority Menu Item ΓòÉΓòÉΓòÉ
  396.  
  397. Use this to examine or change the execution priority of a process.  Only those 
  398. threads and processes belonging to most Presentation Manager application 
  399. programs can have their priority changed. 
  400.  
  401. Note that CPU Monitor can also change its own execution priority if requested. 
  402.  
  403. Priority is selected from the Commands Menu or with the Ctrl-P hot key. 
  404.  
  405.  
  406. ΓòÉΓòÉΓòÉ 8.4. Start Menu Item ΓòÉΓòÉΓòÉ
  407.  
  408. Use this to start a program from CPU Monitor.  The program executes 
  409. independently from and asynchronously to CPU Monitor.  Only OS/2 executable 
  410. programs may be started from CPU Monitor.  Batch files and DOS programs are not 
  411. allowed. 
  412.  
  413. Start is selected from the Commands Menu or with the Ctrl-T hot key. 
  414.  
  415.  
  416. ΓòÉΓòÉΓòÉ 8.5. Suspend Menu Item ΓòÉΓòÉΓòÉ
  417.  
  418. Use this to suspend a currently executing thread or to restart a thread that 
  419. has been suspended.  Only those threads and processes belonging to most 
  420. Presentation Manager application programs can be suspended and restarted. 
  421.  
  422. Suspend is selected from the Commands Menu or with the Ctrl-U hot key. 
  423.  
  424.  
  425. ΓòÉΓòÉΓòÉ 9. Options Menu Help ΓòÉΓòÉΓòÉ
  426.  
  427. Commands available from the Options menu are: 
  428.  
  429.  o Disable the timed screen update; 
  430.  o Enable the timed screen update; 
  431.  o Configure. the CPU Monitor display and data collection. 
  432.  
  433.  
  434. ΓòÉΓòÉΓòÉ 9.1. Configure Menu Item ΓòÉΓòÉΓòÉ
  435.  
  436. Use this to configure the CPU Monitor display and statistics collection. 
  437. Configuration parameters include: 
  438.  
  439.  o Window colors; 
  440.  o Number base; 
  441.  o Screen font; 
  442.  o Display frequency; 
  443.  o Statistics gathering frequency. 
  444.  
  445.  Configure is selected from the Options Menu or with the Ctrl-C hot key. 
  446.  
  447.  
  448. ΓòÉΓòÉΓòÉ 9.1.1. Colors Selection ΓòÉΓòÉΓòÉ
  449.  
  450. Use this to choose between different predefined color schemes.  The current 
  451. color selection can be saved using the Save menu option. 
  452.  
  453. Changing the color scheme is provided by the Configure Dialog. Select Configure 
  454. from the Options Menu or with the Ctrl-C hot key. 
  455.  
  456.  
  457. ΓòÉΓòÉΓòÉ 9.1.2. Number Base Selection ΓòÉΓòÉΓòÉ
  458.  
  459. Use this to select either decimal (base 10) or hexadecimal (base 16) number 
  460. displays.  Hexadecimal values may be useful to correlate CPU Monitor displays 
  461. with other OS/2 system and programming information. The default is to display 
  462. all numbers as decimal integers. 
  463.  
  464. Note:  CPU Percentages are always displayed in decimal integers regardless of 
  465. the specified number base. 
  466.  
  467. Changing the number base is provided by the Configure Dialog. Select Configure 
  468. from the Options Menu or with the Ctrl-C hot key. 
  469.  
  470.  
  471. ΓòÉΓòÉΓòÉ 9.1.3. Font Selection ΓòÉΓòÉΓòÉ
  472.  
  473. Use this to select a different fixed-width font size for the CPU Monitor 
  474. display.  The current display font can be saved using the Save menu option. 
  475.  
  476. Changing the display font is provided by the Configure Dialog. Select Configure 
  477. from the Options Menu or with the Ctrl-C hot key. 
  478.  
  479.  
  480. ΓòÉΓòÉΓòÉ 9.1.4. Change gathering frequency ΓòÉΓòÉΓòÉ
  481.  
  482. Use this to change the statistics gathering method and frequency. There are two 
  483. different modes of operation: 
  484.  
  485.  o Statistics gathering using the CPU Monitor device driver; 
  486.  
  487.  o Statistics gathering from CPU Monitor 
  488.  
  489.  The Slow, Normal, and Fast options specify that statistical data be collected 
  490.  by the CPU Monitor device driver at a rate of 5, 10, and 32 times per second 
  491.  respectively.  This method provides the highest level of accuracy for CPU 
  492.  utilization estimates. 
  493.  
  494.  The Alternate method specifies that CPU Monitor itself gather all statistical 
  495.  information.  This method is less accurate than using the CPU Monitor device 
  496.  driver since CPU Monitor runs as a standard OS/2 application.  As such, its 
  497.  own CPU allocation is in contention with all other applications running on the 
  498.  system. 
  499.  
  500.  Note:  The Alternate method gathers data at a rate dependent on the display 
  501.  frequency. In general, shorter display frequencies provide higher accuracy for 
  502.  the Alternate method.  The display frequency rate has little effect on the 
  503.  device driver modes. 
  504.  
  505.  Refer to the CPU Monitor User's Guide for more details on the statistics 
  506.  gathering methods used in CPU Monitor. 
  507.  
  508.  Changing the statistics gathering frequency is provided by the Configure 
  509.  Dialog.  Select Configure from the Options Menu or with the Ctrl-C hot key. 
  510.  
  511.  
  512. ΓòÉΓòÉΓòÉ 9.1.5. Change display frequency ΓòÉΓòÉΓòÉ
  513.  
  514. Use this to change the display update frequency.  You may select any value 
  515. between 1 and 60 seconds. 
  516.  
  517. Note:  When using the CPU Monitor device driver, process statistics are 
  518. gathered independently of the display frequency.  Different display frequency 
  519. rates will influence statistics gathered by CPU Monitor only when the CPU 
  520. Monitor device driver is not used. 
  521.  
  522. Refer to the CPU Monitor User's Guide for more details on the statistics 
  523. gathering methods used in CPU Monitor. 
  524.  
  525. The display frequency can be saved checking the Save Configuration Info 
  526. checkbox or by using the Save menu option. 
  527.  
  528. The display frequency can also be automatically set when CPU Monitor starts via 
  529. a Command Line switch.  See the User's Guide for details on using the command 
  530. line switches. 
  531.  
  532. Changing the display frequency is provided by the Configure Dialog. Select 
  533. Configure from the Options Menu or with the Ctrl-C hot key. 
  534.  
  535.  
  536. ΓòÉΓòÉΓòÉ 9.2. Disable Menu Item ΓòÉΓòÉΓòÉ
  537.  
  538. Use this to disable the timed display of statistics to the screen.  This  will 
  539. also disable logging output to a file. 
  540.  
  541. Select the Enable menu item to restart the screen display. 
  542.  
  543. Disable is selected from the Options Menu or with the Ctrl-D hot key. 
  544.  
  545.  
  546. ΓòÉΓòÉΓòÉ 9.3. Enable Menu Item ΓòÉΓòÉΓòÉ
  547.  
  548. Use this to enable the timed display of statistics to the screen.  By default, 
  549. the display is normally enabled.  If the Disable option has been invoked, 
  550. Enable will restart the timed display.  This will also restart logging output 
  551. to a file. 
  552.  
  553. Enable is selected from the Options Menu or with the Ctrl-E hot key. 
  554.  
  555.  
  556. ΓòÉΓòÉΓòÉ <hidden> Log File Help ΓòÉΓòÉΓòÉ
  557.  
  558. Enter a filename where the CPU Monitor data will be logged.  Select Enable to 
  559. enable data logging.  Disable will disable data logging.  Overwrite will first 
  560. erase an existing file; Append will add log data to the end of an existing 
  561. file. 
  562.  
  563. Choose OK to confirm the above selections.  Cancel will abort any changes 
  564. selected.  Help displays this message. 
  565.  
  566. If the Log File becomes unavailable or if the file is unable to accommodate 
  567. additional data, an error message will be displayed.  In these cases, file 
  568. logging will be disabled until a new log file is selected. 
  569.  
  570. Note:  Data may be logged to at most one file at a time. 
  571.  
  572. File logging can also be automatically enabled when CPU Monitor starts via a 
  573. Command Line switch.  See the User's Guide for details on using the command 
  574. line switches. 
  575.  
  576.  
  577. ΓòÉΓòÉΓòÉ <hidden> Kill Process Help ΓòÉΓòÉΓòÉ
  578.  
  579. Select the process that is to be terminated.  Press Kill to terminate or press 
  580. Cancel to abort any selections.  If the Confirm Kill Request Checkbox is 
  581. checked, a confirmation request will be issued before the process is killed. 
  582. De-selecting the checkbox eliminates confirmations. 
  583.  
  584. To efficiently kill a series of processes, double click on each Process Name 
  585. instead of pressing the Return key or the Kill pushbutton. 
  586.  
  587. Note that the list of processes is not automatically updated.  Press Refresh to 
  588. update the list.  CPU Monitor retains process information for a period of time 
  589. dependent on the current display frequency. Furthermore, be aware that a 
  590. process may not terminate immediately. 
  591.  
  592. Some processes take measures to avoid being terminated.  The kill request will 
  593. be sent out correctly, but the process may still ignore it and continue to 
  594. execute. 
  595.  
  596.  
  597. ΓòÉΓòÉΓòÉ <hidden> Configure Display Help ΓòÉΓòÉΓòÉ
  598.  
  599. Set configuration parameters for the CPU Monitor display and statistics 
  600. gathering.  The following parameters can be set: 
  601.  
  602. Display Frequency 
  603.  
  604. Enter the number of seconds to wait between screen updates.  You may select any 
  605. value between 1 and 60 seconds. 
  606.  
  607. Note:  The CPU Monitor device driver carries out statistics collecting 
  608. independently of the display frequency.  Nevertheless, the display frequency 
  609. influences statistics gathering when CPU Monitor itself collects the statistics 
  610. without a device driver. 
  611.  
  612. Refer to the CPU Monitor User's Guide for more details on the statistics 
  613. gathering methods used in CPU Monitor. 
  614.  
  615. The display frequency can also be automatically set when CPU Monitor starts via 
  616. a Command Line switch.  See the User's Guide for details on using the command 
  617. line switches. 
  618.  
  619. Statistics Gathering Frequency 
  620.  
  621. Enter the  desired statistics gathering frequency mode.  The Slow, Normal, and 
  622. Fast options specify that statistical data be collected by the CPU Monitor 
  623. device driver at a rate of 5, 10, and 32 times per second.  The Alternate 
  624. method specifies that CPU Monitor itself gather all statistical information. 
  625.  
  626. Number Base 
  627.  
  628. Select either decimal (base 10) or hexadecimal (base 16) number displays. 
  629. Hexadecimal values may be useful to correlate CPU Monitor displays with other 
  630. OS/2 system and programming information.  The default is to display all numbers 
  631. as decimal integers. 
  632.  
  633. Note:  CPU percentages are always displayed in decimal integers regardless of 
  634. the specified number base. 
  635.  
  636. Font Size 
  637.  
  638. Use this to select a different size fixed-width font for the CPU Monitor 
  639. display. 
  640.  
  641. Both font choices are bold, fixed-width, and Courier or System Monospaced, 
  642. depending on the fonts installed in your system.  Generally the large font will 
  643. be ten points, and the small font will be eight points in height. 
  644.  
  645. Colors Scheme 
  646.  
  647. Use this to choose between a number of different predefined color schemes. 
  648.  
  649. Save Configuration Info 
  650.  
  651. Check this to permanently save all configuration information when OK is 
  652. pressed.  The saved configuration information will be used the next time CPU 
  653. Monitor is started. 
  654.  
  655. Press OK to accept the entered values.  If Save Configuration Info is Checked, 
  656. all configuration information will be saved.  Press Escape or Cancel to abort 
  657. any selections.  Press Default to choose the factory default settings. 
  658.  
  659. The Save menu option can also be used to save the current configuration 
  660. settings. 
  661.  
  662.  
  663. ΓòÉΓòÉΓòÉ <hidden> Exit Help   ΓòÉΓòÉΓòÉ
  664.  
  665. Press OK to terminate CPU Monitor.  If the Save Current Setting checkbox is 
  666. checked the following settings are saved: 
  667.  
  668.  o Screen colors; 
  669.  o Display window dimensions; 
  670.  o Display number base; 
  671.  o display font; 
  672.  o Custom display fields and ordering; 
  673.  o Display frequency rate; 
  674.  o Statistics gathering frequency; 
  675.  o Currently selected display. 
  676.  
  677.  Press Cancel to abort any selections and return to CPU Monitor processing. 
  678.  
  679.  
  680. ΓòÉΓòÉΓòÉ <hidden> Start Process Help ΓòÉΓòÉΓòÉ
  681.  
  682. Enter the information necessary to simulate starting a program from the command 
  683. line.  The Working Directory and Parameters entries are optional. If the 
  684. program executes in the background, check Background Task. 
  685.  
  686. Press Start or double click on an entry in the Files list to start the desired 
  687. program.  Only OS/2 executable programs can be started. 
  688.  
  689. Press Reset to quickly erase any information already entered.  Press Cancel to 
  690. abort any selections. 
  691.  
  692. Note:  CPU Monitor can start processes automatically via a Command Line switch. 
  693. See the User's Guide for details on using the command line switches. 
  694.  
  695.  
  696. ΓòÉΓòÉΓòÉ <hidden> Change Priority Help ΓòÉΓòÉΓòÉ
  697.  
  698. Select the process whose priority is to be changed.  The current Priority Class 
  699. and Level are displayed for each selected thread.  Since OS/2 restricts 
  700. changing thread priorities in other processes, only those threads belonging to 
  701. most Presentation Manager programs can have their priority changed. 
  702.  
  703. To change a thread's priority, press Set after selecting new Priority Class and 
  704. Priority Level values.  Press Cancel to abort any selections. Refresh updates 
  705. the display for any processes that have recently terminated or started.  Be 
  706. aware that CPU Monitor retains process information for a period of time 
  707. dependent on the current display frequency. 
  708.  
  709.  
  710. ΓòÉΓòÉΓòÉ <hidden> Display Fields Help ΓòÉΓòÉΓòÉ
  711.  
  712. Select the data fields to display.  Each of the fields is described below: 
  713.  
  714.  o Process ID is the unique identifier for every process. 
  715.  
  716.  o Process Name is the name assigned to the current process.  More than one 
  717.    program with the same name or more than one instance of the same program may 
  718.    be simultaneously loaded for execution; use the Process ID to distinguish 
  719.    between these programs. 
  720.  
  721.  o The process priority value has two parts.  The first digit is the priority 
  722.    class.  OS/2 gives a task with a higher priority class preference over a 
  723.    lower priority class.  The priority classes from lowest to highest are: 
  724.  
  725.     - 1:  Idle Priority 
  726.     - 2-7: Regular and Foreground Priority 
  727.     - 8:  Time Critical Priority 
  728.  
  729.       Each priority class has 32 levels, 0 the lowest priority and 31 the 
  730.       highest (0 to 1F in hexadecimal). 
  731.  
  732.       Be aware that OS/2 normally adjusts each task's priority within a class 
  733.       dynamically, to insure that every task gets some CPU time. 
  734.  
  735.       Note:  The Foreground (or fixed high) priority class actually has a 
  736.       higher priority than the Regular class.  This allows the current screen 
  737.       group to respond more favorably to an interactive user. 
  738.  
  739.  o Threads displays all the threads for each process. 
  740.  
  741.  o Idle Time displays the estimated percentage of the time that the CPU is 
  742.    idle. 
  743.  
  744.  o State displays the execution state of a process or thread.  It may be Ready 
  745.    if the process or thread is ready or currently executing.  If the thread is 
  746.    not Ready, it may be Blocked or Frozen. 
  747.  
  748.  o Session ID is the session or screen group identifier. 
  749.  
  750.  o Percent CPU Time displays an estimate of how much CPU time each thread or 
  751.    process is using. 
  752.  
  753.  o Parent Process ID displays the identifier for each thread or process. 
  754.  
  755.  o Use Defaults selects the default display values. 
  756.  
  757.    The numeric fields are displayed in the current number base, either decimal 
  758.    or hexadecimal.  The number base is changed from the Configure dialog. 
  759.  
  760.    Press OK to enable the display with the new field selections.  Press Cancel 
  761.    to abort any selections.  Press Default to choose the factory default 
  762.    settings. 
  763.  
  764.  
  765. ΓòÉΓòÉΓòÉ <hidden> Display Order Help ΓòÉΓòÉΓòÉ
  766.  
  767. Select how the display is to be ordered.  The display is arranged in either 
  768. ascending or descending order based on one of the following: 
  769.  
  770.  o Process Name; 
  771.  o Process ID; 
  772.  o Session ID; 
  773.  o Parent's Process ID; 
  774.  o CPU Time used; 
  775.  o Process Priority. 
  776.  
  777.  Press OK to select the new display order.  Press Cancel to abort any 
  778.  selections. 
  779.  
  780.  
  781. ΓòÉΓòÉΓòÉ <hidden> Select Process Help ΓòÉΓòÉΓòÉ
  782.  
  783. Select specific processes and threads to include in the display.  Only those 
  784. items selected will appear in the display. 
  785.  
  786. Press OK to include the selected processes in the display.  Press Cancel to 
  787. abort any new selections. 
  788.  
  789. Note:  To display data for all processes, make sure that no entries in the 
  790. Process List are selected.  Press Reset to quickly clear any selected entries. 
  791.  
  792.  
  793. ΓòÉΓòÉΓòÉ <hidden> Suspend Thread Help ΓòÉΓòÉΓòÉ
  794.  
  795. Select the process and thread to be suspended or resumed.  If the state for a 
  796. thread is displayed as 'Suspend', then that thread is currently suspended. 
  797. 'Normal' indicates that the thread is not suspended. 
  798.  
  799. Since OS/2 places restrictions on suspending threads in other processes, only 
  800. those threads belonging to most Presentation Manager programs can be suspended 
  801. or resume executing. 
  802.  
  803. Press Refresh to update the display for any processes that have recently 
  804. terminated or started.  Be aware that CPU Monitor retains process information 
  805. for a period of time dependent on the current display frequency. 
  806.  
  807. Press Set to change the execution state for the selected thread.  Press Cancel 
  808. to return to the CPU Monitor display. 
  809.  
  810. Warning: It may NOT be possible to resume a process whose sole 'Message Loop' 
  811. thread has been suspended.  In many programs, the first thread (Thread 1) has 
  812. the responsibility for dispatching all messages for that process in a message 
  813. loop.  This thread is referred to as the message loop thread.  Therefore, if 
  814. you choose to suspend Thread 1 in any process, a warning will be displayed. 
  815.  
  816. Suspended threads may sometimes be identified by a "Frozen" entry in CPU 
  817. Monitor's "State" column.  "State" is included in the customized display via 
  818. the Fields menu item. 
  819.  
  820.  
  821. ΓòÉΓòÉΓòÉ <hidden> Installation Help ΓòÉΓòÉΓòÉ
  822.  
  823. CPU Monitor must initially be installed in your system.  After starting CPU 
  824. Monitor from the OS/2 Command Line, select YES when prompted to continue with 
  825. the installation. 
  826.  
  827. After installation is complete, the computer should then be restarted to enable 
  828. all CPU Monitor functions. 
  829.  
  830. Note that part of the installation process requires that the CPU Monitor help 
  831. file and dynamic link library be copied to their OS/2 directories.  In 
  832. addition, the CPU Monitor device driver must be referenced from the CONFIG.SYS 
  833. file.  Refer to the CPU Monitor User's Guide for more information. 
  834.  
  835. To permanently unload CPU Monitor from your system, select the UnInstall menu 
  836. item from the File menu.  The Un-Installation process will be complete after 
  837. the computer has been restarted.  CPU Monitor may be reinstalled later at your 
  838. convenience. 
  839.  
  840.  
  841. ΓòÉΓòÉΓòÉ <hidden> Installation Error Help ΓòÉΓòÉΓòÉ
  842.  
  843. CPU Monitor was unable to complete the installation process.  If you press OK 
  844. to continue, not all CPU Monitor functions will be available. 
  845.  
  846.  
  847. ΓòÉΓòÉΓòÉ <hidden> Installation Error Help ΓòÉΓòÉΓòÉ
  848.  
  849. CPU Monitor was unable to backup the system OS2.INI file.  Since CPU Monitor 
  850. makes changes to OS2.INI, it first makes a backup copy called OS2INI.BA.  This 
  851. backup file is put in the same directory where OS2.INI is found. 
  852.  
  853. At this point, you may still continue installing CPU Monitor.  However, in the 
  854. very unlikely event that the OS2.INI file becomes corrupt, CPU Monitor will not 
  855. have created the OS2INI.BA backup. 
  856.  
  857. Select YES to continue with the installation process.  Select NO to abort the 
  858. installation. 
  859.  
  860.  
  861. ΓòÉΓòÉΓòÉ <hidden> Initialization Error Help ΓòÉΓòÉΓòÉ
  862.  
  863. CPU Monitor has not been completely installed.  As a result, some CPU Monitor 
  864. functions will not operate correctly. 
  865.  
  866. To install CPU Monitor, restart the program and press 'Yes' when asked to 
  867. install.  Then restart OS/2 to complete the installation process. 
  868.  
  869. Note:  Part of the installation process includes copying the CPU Monitor 
  870. dynamic link library, CPUMON.DLL, to one of the directories specified by the 
  871. CONFIG.SYS LIBPATH command. 
  872.  
  873. Refer to the CPU Monitor User's Guide for information on installing CPU 
  874. Monitor. 
  875.  
  876.  
  877. ΓòÉΓòÉΓòÉ <hidden> Initialization Error Help ΓòÉΓòÉΓòÉ
  878.  
  879. CPU Monitor has not been completely installed.  As a result, some CPU Monitor 
  880. functions will not operate correctly. 
  881.  
  882. To install CPU Monitor, restart the program and press `Yes' when asked to 
  883. install.  Then restart OS/2 to complete the installation process. 
  884.  
  885. Note:  Part of the installation process includes referencing the CPU Monitor 
  886. device driver, CPUMON.SYS, from the CONFIG.SYS file as in the following 
  887. example. 
  888.  
  889. Example:
  890.   device=C:\MONITOR\CPUMON.SYS
  891.  
  892. Refer to the CPU Monitor User's Guide for information on installing CPU 
  893. Monitor. 
  894.  
  895.  
  896. ΓòÉΓòÉΓòÉ <hidden> UnInstallation Help ΓòÉΓòÉΓòÉ
  897.  
  898. To permanently remove CPU Monitor from your system, select YES when prompted to 
  899. Un-Install. 
  900.  
  901. After Un-Installing, CPU Monitor will be completely removed once the computer 
  902. has been restarted. 
  903.  
  904. Note:  Part of the installation process requires that the CPU Monitor device 
  905. driver be referenced from the CONFIG.SYS file.  This reference is not removed 
  906. automatically.  Refer to the CPU Monitor User's Guide for more information. 
  907.  
  908. CPU Monitor may be installed later at your convenience. 
  909.  
  910.  
  911. ΓòÉΓòÉΓòÉ <hidden> Log File Error Help ΓòÉΓòÉΓòÉ
  912.  
  913. If the log file becomes unavailable or if the file is unable to accomodate 
  914. additional data, an error message will be displayed.  In these cases, file 
  915. logging will be disabled until a new log file is selected. 
  916.  
  917. Note:  Data may be logged to at most one file at a time. 
  918.  
  919.  
  920. ΓòÉΓòÉΓòÉ <hidden> Kill Process Error Help ΓòÉΓòÉΓòÉ
  921.  
  922. The selected process no longer exists.  Choose another process to kill or 
  923. select Cancel to return to CPU Monitor. 
  924.  
  925. Note:  The list of processes in the Kill Process dialog box is not 
  926. automatically updated.  Press Refresh at any time to update the display for 
  927. processes that have recently started or terminated. Be aware that CPU Monitor 
  928. retains process information for a period of time dependent on the current 
  929. display frequency. 
  930.  
  931.  
  932. ΓòÉΓòÉΓòÉ <hidden> Kill Process Confirmation Help ΓòÉΓòÉΓòÉ
  933.  
  934. The specified process is to be killed.  Press OK to kill the process. Press 
  935. CANCEL to abort. 
  936.  
  937.  
  938. ΓòÉΓòÉΓòÉ <hidden> Change Priority Error Help ΓòÉΓòÉΓòÉ
  939.  
  940. CPU Monitor is unable to determine the priority for the selected process.  This 
  941. may occur if the selected process has terminated. Choose another process or 
  942. press Cancel to return to CPU Monitor. 
  943.  
  944. Note:  The list of processes in the Change Priority dialog box is not 
  945. automatically updated.  Press Refresh at any time to update the display for 
  946. processes that have recently started or terminated. Be aware that CPU Monitor 
  947. retains process information for a period of time dependent on the current 
  948. display frequency. 
  949.  
  950.  
  951. ΓòÉΓòÉΓòÉ <hidden> Suspend Thread Error Help ΓòÉΓòÉΓòÉ
  952.  
  953. CPU Monitor is unable to determine the execution state for the selected process 
  954. and thread.  This may occur if the selected process or thread has terminated. 
  955. Choose another thread or press Cancel to return to CPU Monitor. 
  956.  
  957. Note:  The list of processes in the Suspend Thread dialog box is not 
  958. automatically updated.  Press Refresh at any time to update the display for 
  959. processes and threads that have recently started or terminated.  Be aware that 
  960. CPU Monitor retains process information for a period of time dependent on the 
  961. current display frequency. 
  962.  
  963.  
  964. ΓòÉΓòÉΓòÉ <hidden> Clipboard Warning Help ΓòÉΓòÉΓòÉ
  965.  
  966. CPU Monitor was unable to completely copy the current display to the clipboard. 
  967. Data at the end of the display may have been lost. The maximum number of 
  968. characters that can be copied is approximately 65,535 bytes. 
  969.  
  970. Retry the copy when the current display contains less information. You can 
  971. reduce the quantity of information displayed by using the Fields and Select 
  972. dialogs. 
  973.  
  974. Alternatively, you may copy a bitmap image of the current display to the 
  975. clipboard by selecting the Copy Bitmap menu item.  This differs from Copy Text 
  976. since only the visible display will be copied. 
  977.  
  978.  
  979. ΓòÉΓòÉΓòÉ <hidden> Configuration Error Help ΓòÉΓòÉΓòÉ
  980.  
  981. The FAST, Normal, and Slow Gather Frequencies are only available if the CPU 
  982. Monitor device driver has been installed. 
  983.  
  984. Refer to the CPU Monitor User's Guide for information on installing CPU 
  985. Monitor. 
  986.  
  987.  
  988. ΓòÉΓòÉΓòÉ <hidden> Configuration Error Help ΓòÉΓòÉΓòÉ
  989.  
  990. At installation time, CPU Monitor tries to find an installed fixed pitch 
  991. Courier font to match your screen resolution.  If this is unsuccessful, it 
  992. tries to find a fixed pitch System Monospaced font. 
  993.  
  994. This error message indicates that CPU Monitor was unable to find the desired 
  995. size font to match your screen resolution. 
  996.  
  997. Check to be sure that OS/2 has Courier and System Monospaced fonts to match 
  998. your screen resolution. 
  999.  
  1000.  
  1001. ΓòÉΓòÉΓòÉ 10. Command Line Switches ΓòÉΓòÉΓòÉ
  1002.  
  1003. The following command line switches are available: 
  1004.  
  1005.  o /START=<fname> 
  1006.  o /LOG=<fname> 
  1007.  o /FREQUENCY=<seconds> 
  1008.  
  1009.  For /START, <fname> is the name of a file containing the program names to be 
  1010.  started. 
  1011.  
  1012.  For /LOG, <fname> is the name of the file where logging information will be 
  1013.  written. 
  1014.  
  1015.  For /FREQUENCY, <seconds> is the number of seconds (1 to 60) between screen 
  1016.  updates. 
  1017.  
  1018.  Note:  No spaces are allowed between the equals sign ('=') and the value in a 
  1019.  command line switch.  Spaces are required between each command line parameter. 
  1020.  
  1021.   Example:
  1022.     MONITOR /FREQUENCY=5 /LOG=C:\mylog.log /START=C:\bastart.ba
  1023.  will do the following: 
  1024.  
  1025.  o Sets the initial display frequency to 5 seconds; 
  1026.  o Enables file logging to the file C:\MYLOG.LOG; 
  1027.  o Starts the programs as specified in the file C:\START.BA. 
  1028.  
  1029.  Once CPU Monitor is running, data logging may be changed by selecting the Log 
  1030.  menu item; Additional programs may be started via the Start menu item; The 
  1031.  display frequency may be changed via the Configure menu item. 
  1032.  
  1033.  See the User's Guide for more details on using the command line switches.